Node / meshtastic / Meshtastic-Android / files / core / ble / src / androidMain / kotlin / org / meshtastic / core / ble / AndroidBleScanStartLimiter.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.ble

Tff7b72import T7ee787kotlinx.coroutines.sync.Mutex

Tff7b72import T7ee787kotlinx.coroutines.sync.withLock

Tff7b72import T7ee787kotlin.time.Duration

Tff7b72import T7ee787kotlin.time.Duration.Companion.seconds

Tff7b72import T7ee787kotlin.time.TimeMark

Tff7b72import T7ee787kotlin.time.TimeSource

Tff7b72internal Tff7b72const Tff7b72val Te6edf3ANDROID_BLE_SCAN_START_LIMIT Tff7b72= T79c0ff5

Tff7b72internal Tff7b72val Te6edf3ANDROID_BLE_SCAN_START_WINDOWTb4b4b4: Te6edf3Duration Tff7b72= T79c0ff3T79c0ff0.Te6edf3seconds

T8b949e/**

* Reserves Android BLE scan starts before Kable reaches BluetoothLeScanner.

*

* Android rejects the sixth scan start inside its rolling quota window. Some framework versions intentionally suppress

* the corresponding app callback, which leaves a scanner flow waiting without advertisements or a useful exception.

* Keeping the same rolling window in-process makes that condition deterministic and recoverable by callers.

*/

Tff7b72internal Tff7b72class T56d364AndroidBleScanStartLimiterTb4b4b4(

Tff7b72private Tff7b72val Te6edf3timeSourceTb4b4b4: Te6edf3TimeSource Tff7b72= Te6edf3TimeSourceTb4b4b4.Te6edf3MonotonicTb4b4b4,

Tff7b72private Tff7b72val Te6edf3maxStartsTb4b4b4: Tffa657Int Tff7b72= Te6edf3ANDROID_BLE_SCAN_START_LIMITTb4b4b4,

Tff7b72private Tff7b72val Te6edf3windowTb4b4b4: Te6edf3Duration Tff7b72= Te6edf3ANDROID_BLE_SCAN_START_WINDOWTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3BleScanStartLimiter Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3mutex Tff7b72= Te6edf3MutexTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3scanStarts Tff7b72= Te6edf3ArrayDequeTff7b72<Te6edf3TimeMarkTff7b72>Tb4b4b4(Tb4b4b4)

Tff7b72init Tb4b4b4{

Te6edf3requireTb4b4b4(Te6edf3maxStarts Tff7b72> T79c0ff0Tb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffmaxStarts must be positiveTa5d6ff" Tb4b4b4}

Te6edf3requireTb4b4b4(Te6edf3windowTb4b4b4.Te6edf3isPositiveTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffwindow must be positiveTa5d6ff" Tb4b4b4}

Tb4b4b4}

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffreserveStartTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3mutexTb4b4b4.Te6edf3withLock Tb4b4b4{

Te6edf3discardExpiredStartsTb4b4b4(Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3scanStartsTb4b4b4.Te6edf3size Tff7b72>Tff7b72= Te6edf3maxStartsTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3retryAfter Tff7b72= Tb4b4b4(Te6edf3window Tff7b72- Te6edf3scanStartsTb4b4b4.Te6edf3firstTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3elapsedNowTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4.Te6edf3coerceAtLeastTb4b4b4(Te6edf3DurationTb4b4b4.Te6edf3ZEROTb4b4b4)

Tff7b72throw Te6edf3BleScanStartExceptionTb4b4b4(

Te6edf3reason Tff7b72= Te6edf3BleScanStartFailureReasonTb4b4b4.Te6edf3ScanningTooFrequentlyTb4b4b4,

Te6edf3cause Tff7b72= Te6edf3IllegalStateExceptionTb4b4b4(Ta5d6ff"Ta5d6ffAndroid BLE scan-start quota exhaustedTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3retryAfter Tff7b72= Te6edf3retryAfterTb4b4b4,

Tb4b4b4)

Tb4b4b4}

Te6edf3scanStartsTb4b4b4.Te6edf3addTb4b4b4(Te6edf3timeSourceTb4b4b4.Te6edf3markNowTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffdiscardExpiredStartsTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72while Tb4b4b4(Te6edf3scanStartsTb4b4b4.Te6edf3firstOrNullTb4b4b4(Tb4b4b4)Tff7b72?.Te6edf3elapsedNowTb4b4b4(Tb4b4b4)Tff7b72?.Te6edf3let Tb4b4b4{ Tffa657it Tff7b72>Tff7b72= Te6edf3window Tb4b4b4} Tff7b72=Tff7b72= Tff7b72trueTb4b4b4) Tb4b4b4{

Te6edf3scanStartsTb4b4b4.Te6edf3removeFirstTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72val Te6edf3processBleScanStartLimiterTb4b4b4: Te6edf3BleScanStartLimiter Tff7b72= Te6edf3AndroidBleScanStartLimiterTb4b4b4(Tb4b4b4)

Tff7b72internal Tff7b72actual Tff7b72fun Td2a8ffcreateBleScanStartLimiterTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3BleScanStartLimiter Tff7b72= Te6edf3processBleScanStartLimiter